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¢ First, reminders of what SPICE means by: 
— reference frame 
— coordinate system 
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What is a Reference Frame? 
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¢ Within SPICE, a reference frame is specified by three 
orthogonal axes 


¢ It may be fixed in space (not rotating, not accelerating) 
— This is called an inertial frame 

¢ It may be changing its orientation in space 
— This is called a non-inertial frame 

¢ Every frame has a name and a numeric ID assigned to it 
— You'll use the name as an argument in calling Toolkit APIs 


¢ Every frame has an associated center location 
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What is a Coordinate System? 
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¢ Within SPICE, a coordinate system is the method used to 
specify a vector within a reference frame. Examples: 
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What does the SPICE FRAMES subsystem do? 


1. It establishes relationships between reference frames used 
in geometry computations — it "chains frames together” in 
a frame tree. 


2. It connects frames with the sources of their orientation 
specifications. 
— In some cases those data are included in the Frames kernel 
itself. 


Based on these relationships and the orientation source 
information, the frames subsystem allows SPICE software to 
compute rotations between neighboring frames in the frame 
tree, and to combine these rotations in the right order, thus 
providing an ability to compute the orientation of any frame in 
the tree with respect to any other frame in the tree, at any time. 
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Sample Frame Tree 
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¢ Frame names are character strings used to 
identify frames to Toolkit APIs 


¢ Examples of frame names: 
— J2000 
— IAU_MARS 
— DAWN_SPACECRAFT 
— MEX_OMEGA 
— DSS-14_ TOPO 
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NAIE> Where to Find the Names of Frames? 
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¢ Refer to the “NAIF IDs” Tutorial for an introduction to 
reference frame names and IDs 


¢ Refer to the FRAMES.REQ document for the list of NAIF 
“built in” (hard coded) inertial and body-fixed frames 


¢ Refer to a mission’s Frames Kernel (FK) file for a list of 
frames defined for the spacecraft, its subsystems and 
instruments 


¢ Refer to an earth stations FK for a list of frames defined for 
the DSN and other stations 


¢ Refer to the moon FKs for names and descriptions of the 
body-fixed frames defined for the moon 
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Frame Classes and Examples 
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Frame class Frame Examples (with real frame names) 
Inertial ¢ Earth Equator/Equinox of Epoch (ICRF, also called J2000 in SPICE) 


¢ Planet Equator/Equinox of Epoch (MARSIAU, ...) 
¢ Ecliptic of Epoch (ECLIPJ2000, ...) 


Body-fixed ¢ Solar system body IAU frames (IAU_MARS, IAU_SATURN, ...) 
¢ High accuracy Earth frames (ITRF939, ...) 
¢ High accuracy Moon frames (MOON_PA, MOON_ME) 


CK-based ¢ Spacecraft (CASSINI_SC_BUS, ...) 
¢ Moving parts of an instrument (MPL_RA_JOINT‘1, ...) 


Fixed Offset ¢ Instrument mounting alignment (CASSINI_ISS_NAC, ...) 
¢ Topocentric (DSS-14 TOPO, ...) 


Dynamic * Geomagnetic 
¢ Geocentric Solar Equatorial 
¢ Planet true equator and equinox of date 


Switch ¢ Spacecraft frame switching between reconstructed and predicted CK frames 
¢ Nominal attitude profile frame switching between dynamic frames 
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Frame class 


Inertial 
Body-fixed 
CK based 
Fixed offset 
Dynamic 


Switch 
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Frame Class Specifications 
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Frame Defined in: 
Toolkit software 
Toolkit software or FK 
FK 


FK 


FK 


FK 


Orientation data provided in: 
Toolkit software 

PCK (text or binary style) 

CK 


FK 


Toolkit software, or computed 
using FK, SPK, CK, and/or PCK 


Toolkit software, or computed 
using FK, SPK, CK, and/or PCK 
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¢ Uses the SPICE text kernel standards 
¢ Loaded using the FURNSH routine 


¢ Usually contains comprehensive information about the 
defined frames in the comment section(s) of the file 


¢ Contains frame definition information consisting of a set of 
keywords in the data sections of the file. Below are examples 
defining a CK-based frame and a fixed-offset frame. 


CK-based Frame Example Fixed-offset Frame Example 


FRAME DAWN SPACECRAFT = -203000 FRAME DAWN FC1 -203110 
FRAME -203000 NAME 'DAWN_ SPACECRAFT’ FRAME -203110 NAME 'DAWN_FC1’ 
FRAME -203000 CLASS 3 FRAME -203110 CLASS 4 
FRAME -203000 CLASS ID = -203000 FRAME -203110 CLASS ID -203110 
FRAME -203000 CENTER -203 FRAME -203110 CENTER -203 
-203 TKFRAME -203110 RELATIVE = 'DAWN SPACECRAFT’ 
-203 TKFRAME -203110 SPEC ' ANGLES’ 
TKFRAME -203110 UNITS 'DEGREES’ 
TKFRAME -203110 ANGLES (0.0, 0.0, 0.0 ) 
TKFRAME -203110 AXES (1, 2, 3.) 


CK_-203000 SCLK 
CK_-203000 SPK 


¢ These examples are discussed in detail in the next few slides 


Frames Subsystem 


11 


Frame Definition Details - 1 
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Frame definition for the DAWN spacecraft Frame definition for the DAWN Framing Camera #1 
FRAME DAWN _SPACECRAFT -203000 FRAME DAWN _FC1 -203110 
FRAME -203000_NAME 'DAWN_SPACECRAFT’ FRAME -203110 NAME 'DAWN_FC1’ 
FRAME -203000 CLASS 3 FRAME -203110 CLASS 4 
FRAME -203000 CLASS ID = -203000 FRAME -203110 CLASS ID -203110 
FRAME -203000 CENTER -203 FRAME -203110 CENTER -203 
-203 TKFRAME -203110 RELATIVE 'DAWN SPACECRAFT’ 
-203 TKFRAME -203110 SPEC ' ANGLES’ 

TKFRAME -203110 UNITS 'DEGREES’ 


TKFRAME -203110 ANGLES ( 0.0, 0.0, 
(1, 2, 


CK_-203000 SCLK 
CK _-203000 SPK 


TKFRAME -203110 AXES 


¢ The Frame ID, shown in red in the two examples 
above, is an integer number used by the SPICE 
system as a “handle” in buffering and retrieving 
various parameters associated with a frame. In an FK 
it “glues together” the keywords defining the frame. 
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Frame Definition Details - 2 
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Frame definition for the DAWN spacecraft Frame definition for the DAWN Framing Camera #1 
FRAME DAWN SPACECRAFT = -203000 FRAME DAWN _FC1 -203110 
FRAME -203000 NAME 'DAWN_SPACECRAFT’ FRAME -203110 NAME = 'DAWN _FC1’ 
FRAME -203000 CLASS 3 FRAME -203110 CLASS 4 
FRAME -203000 CLASS ID = -203000 FRAME -203110 CLASS ID -203110 
FRAME -203000 CENTER -203 FRAME -203110 CENTER -203 


CK -203000 SCLK -203 TKFRAME -203110 RELATIVE = 'DAWN SPACECRAFT’ 
CK -203000 SPK = -203 TKFRAME -203110 SPEC ' ANGLES’ 

TKFRAME -203110 UNITS ' DEGREES’ 

TKFRAME -203110 ANGLES ( 0.0, 

TKFRAME -203110 AXES =(1, 2, 


¢ These keywords 
FRAME <name> = <id> 
FRAME <id> NAME = <name> 


establish the association between the name and the ID 
of the frame. 
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Frame Definition Details - 3 
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Frame definition for the DAWN spacecraft Frame definition for the DAWN Framing Camera #1 
FRAME DAWN SPACECRAFT -203000 FRAME DAWN_FC1 -203110 
FRAME -203000 NAME 'DAWN_SPACECRAFT’ FRAME -203110 NAME 'DAWN_FC1’ 
FRAME -203000 CLASS 2 FRAME -203110 CLASS 4 
FRAME -203000 CLASS ID = -203000 FRAME -203110 CLASS ID -203110 
FRAME -203000 CENTER -203 FRAME -203110_ CENTER -203 
-203 TKFRAME -203110 RELATIVE 'DAWN_SPACECRAFT’ 
-203 TKFRAME -203110 SPEC 'ANGLES’ 
TKFRAME -203110 UNITS 'DEGREES’ 
TKFRAME -203110 ANGLES (0.0, 0.0, 0.0 ) 
TKFRAME -203110_ AXES (1, 2, 3. ) 


CK_-203000 SCLK 
CK _-203000 SPK 


¢ The FRAME...CLASS keyword specifies the method 
by which the frame is related to its base frame 


¢ This keyword is set to: 
1, for inertial frames 

2, for PCK-based frames 
3, for CK-based frames 
4, for fixed-offset frames 
5, 


for dynamic frames os 
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Frame Definition Details - 4 
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Frame definition for the DAWN spacecraft Frame definition for the DAWN Framing Camera #1 
FRAME DAWN _SPACECRAFT -203000 FRAME DAWN _FC1 = -203110 
FRAME -203000_ NAME 'DAWN_SPACECRAFT’ FRAME -203110 NAME = 'DAWN FC1’ 
FRAME -203000 CLASS 3 FRAME -203110 CLASS 
FRAME -203000 CLASS ID = -203000 FRAME -203110 CLASS ID -203110 
FRAME -203000_ CENTER -203 FRAME -203110 CENTER = -203 
-203 TKFRAME -203110 RELATIVE 'DAWN_SPACECRAFT’ 
-203 TKFRAME -203110 SPEC 'ANGLES’ 

TKFRAME -203110 UNITS 'DEGREES’ 
TKFRAME -203110_ ANGLES ( 0.0, 
TKFRAME ~203110 AXES Ci, 2, 


CK _-203000 SCLK 
CK -203000 SPK 


¢ The FRAME...CLASS_ID is the number that connects a frame with the 
orientation data for it. 


— For body-fixed frames the CLASS ID is the ID of the natural body. It is used as input to 
PCK routines called by the Frame subsystem to compute orientation of the frame. 


» The Frame ID and CLASS_ID are not the same for the body-fixed frames defined in 
the Toolkit but they can be the same for frames defined in FK files. 


— For CK-based frames the CLASS _ID is the CK structure ID. It is used as input to CK 
routines called by the Frame subsystem to compute orientation of the frame. 


» Usually the CLASS_ID of a CK-based frame is the same as the frame ID, but this is 
not required. 


— For fixed offset and dynamic frames the CLASS ID is the ID that is used to retrieve the 
frame definition keywords. 


» The CLASS _ID of a fixed offset or dynamic frame is the same as the frame ID. 
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Frame Definition Details - 5 
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Frame definition for the DAWN spacecraft Frame definition for the DAWN Framing Camera #1 
FRAME DAWN SPACECRAFT -203000 FRAME DAWN_FC1 -203110 
FRAME -203000 NAME 'DAWN_SPACECRAFT’ FRAME -203110 NAME 'DAWN_FC1’ 
FRAME -203000 CLASS 3 FRAME -203110 CLASS 4 
FRAME -203000 CLASS ID = -203000 FRAME -203110 CLASS ID -203110 
FRAME -203000 CENTER -203 FRAME -203110 CENTER -203 
-203 TKFRAME -203110 RELATIVE 'DAWN_SPACECRAFT’ 
-203 TKFRAME -203110 SPEC 'ANGLES’ 
TKFRAME -203110 UNITS 'DEGREES’ 
TKFRAME -203110 ANGLES (0.0, 0.0, 0.0 ) 
TKFRAME -203110_ AXES (1, 2, 3. ) 


CK_-203000 SCLK 
CK _-203000 SPK 


¢ The FRAME...CENTER specifies the ephemeris object 
at which the frame origin is located 


— It is used ONLY to compute the light-time corrected 
orientation of the frame 
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Frame Definition Details - 6 
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Frame definition for the DAWN spacecraft Frame definition for the DAWN Framing Camera #1 
FRAME DAWN _SPACECRAFT -203000 FRAME DAWN _FC1 -203110 
FRAME -203000 NAME 'DAWN_SPACECRAFT’ FRAME -203110 NAME 'DAWN_FC1’ 
FRAME -203000 CLASS 3 FRAME -203110 CLASS 4 
FRAME -203000 CLASS ID = -203000 FRAME -203110 CLASS ID -203110 
FRAME -203000 CENTER -203 FRAME -203110 CENTER -203 
-203 TKFRAME -203110 RELATIVE 'DAWN SPACECRAFT’ 
-203 TKFRAME -203110 SPEC ' ANGLES’ 

TKFRAME -203110 UNITS 'DEGREES’ 
TKFRAME -203110 ANGLES (0.0; 
TKFRAME -203110 AXES Ca, 2) 


CK_-203000 SCLK 
CK_-203000 SPK 


¢ Additional frame definition keywords may be required depending 
on the frame class 
— For CK frames, CK...SCLK and CK...SPK keywords identify the 
spacecraft clock ID and physical object ID associated with the CK 
structure ID 


— For fixed-offset frames, TKFRAME_* keywords specify the base 
frame and the fixed orientation with respect to this frame 


— For dynamic frames, additional keywords depend on the dynamic 
frame family 
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NAIE> APIs Using the Frames Subsystem 
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SXFORM, PXFORM, 
and PXFRM2 


CALL SXFORM( ‘FROM_FRAME NAME’, 
CALL PXFORM( ‘FROM_FRAME NAME’, 
CALL PXFRM2( ‘FROM FRAME NAME’, 


return state or position 
transformation matrix 


‘TO FRAME NAME’, ET, MAT6x6 ) 
‘TO FRAME NAME’, ET, MAT3X3 ) 
‘TO FRAME NAME’, ETFROM, ETTO, MAT3X3 ) 


SPKEZR and SPKPOS __ return state or position 


vector in specified frame 


CALL SPKEZR( BOD, ET, ‘FRAME NAME’, CORR, OBS, STATE, LT ) 
CALL SPKPOS( BOD, ET, ‘FRAME NAME’, CORR, OBS, POSITN, LT ) 


The above are FORTRAN examples, using SPICELIB APIs. 
The same interfaces exist for the other supported languages (CSPICE, Icy, Mice). 
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CK-Based Frames “Must Know” 
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These are VERY IMPORTANT points you must understand! 


The frames routines (SPKEZR, SPKPOS, SXFORM, PXFORM) all read CK 
files using tolerance = 0 
— For discrete CKs (Type 1) the orientation of a CK-based frame will be computed only if the 


time provided to a Frames routine exactly matches one of the times stored in the CK file; 
otherwise an error will be signaled. 


— Forcontinuous CKs (Types 2 - 6) the orientation of a CK-based frame will be computed only 
if the time bade to a Frames routine falls within one of the interpolation intervals defined 
by the CK file; otherwise an error will be signaled. 


Using SPKEZR or SXFORM requires CKs that contain angular rate data 


— Since these routines return a state vector (6x1) or state transformation matrix (6x6), angular 
rate must be present in the CK in order to compute vectors and matrices; if angular rate is 
not present an error will be signaled. 


— SPKPOS and PXFOR\M, which return a position vector ae and a position transformation 
matrix (3x3) respectively, can be used when angular rate data are NOT present in a CK. 
Ephemeris time input to Frames routines is converted to SCLK to access 
Ks 
— SCLK and LSK kernels must be loaded to support this conversion. 


— The SCLK ID is specified in one of the CK frame definition keywords; if not, it’s assumed to 
be the Frame ID divided by 1000. 
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Frame Tree Example: 
ASPERA Instrument on Mars Express 
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"J2000" <-inertial 


foo o-oo o-oo oe -- - - -------- + 
| | | 
|<-pcek | |<-pck 
| | | 
Vv | Vv 
"IAU_MARS" | "IAU_EARTH" 
MARS BODY-FIXED |<-ck EARTH BODY-FIXED 
aS Sa es Se | i a pe a re 
Vv 
"MEX SPACECRAFT" 
$--- 9-5-5 5 == + 
| | 
|<-fixed |<-fixed 
| | 
Vv Vv 
"MEX ASPERA_URF" "MEX ASPERA_IMA URF" 
| | 
|<-ck |<-fixed 
| | 
Vv Vv 
"MEX ASPERA_ SAF” “MEX _ASPERA_IMA” 
| | | 
|<-fixed |<-fixed |<-fixed 
| | | 
Vv Vv Vv 
"MEX ASPERA_ ELS" "MEX ASPERA NPI" "MEX ASPERA_NPD1" 


Blue text indicates frame class 
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FK Utility Programs 
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¢ The following FK and frames utility programs are included in 


the Toolkit 
FRMDIFF = samples orientation of a frame or compares orientation of 
two frames 
CKBRIEF summarizes coverage for one or more CK files 
BRIEF summarizes coverage for one or more binary PCK files 


¢ These additional FK and frames utility programs are 
provided on the NAIF Web site 


PINPOINT creates SPK and topocentric frames FK files for fixed 
locations (ground stations, etc) 


BINGO converts FK files between UNIX and DOS text formats 
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Additional Information on FK 
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¢ For more information about FK and frames, look 
at the following documents 
— Frames Required Reading 
— Using Frames Tutorial 
— Dynamic Frames Tutorial 
— NAIF IDs Tutorial 
— Headers for the routines mentioned in this tutorial 
— Most Useful SPICELIB Routines 
— FRMDIFF User’s Guide 
— Porting_kernels tutorial 


¢ Related documents 


— CK Required Reading 

— PCK Required Reading 

— SPK Required Reading 

— Rotations Required Reading 
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